home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / jcal003.zip / JCAL.DOC < prev    next >
Text File  |  1996-01-09  |  7KB  |  206 lines
  1.  
  2. --------------------------------------------------------------------------------
  3.  1. LICENCE AGREEMENT
  4.  
  5.    JCAL is Freeware. You may freely use or distribute it as you see fit,
  6.  subject to the following conditions:
  7.  
  8.  - You may not charge a fee for using or distributing JCAL, except to
  9.    cover the cost of media and copying.
  10.  - All the files in the original distribution package are distributed
  11.    together, and in their original, unmodified form. You may repack the
  12.    archive if you wish, as long as you include all the files. A complete
  13.    file list appears in this document in section 3, "File List".
  14.  
  15.    These are not unreasonable conditions. In fact, these are pretty
  16.  standard for most Freeware and Public Domain software.
  17.  
  18.    JCAL and all associated files remain the property of the author, as
  19.  identified in this document. Your licence to use or distribute the
  20.  software does not imply ownership on you. This paragraph applies to all
  21.  the files included in the original distribution package, but excludes the
  22.  output file produced by JCAL.
  23.  
  24.  
  25. --------------------------------------------------------------------------------
  26.  2. DISCLAIMER
  27.  
  28.    Possession and use of JCAL is entirely at your own risk. The author
  29.  will not be held responsible for any damage or loss incurred as a result
  30.  of the use, misuse or inability to use the software. JCAL has been
  31.  carefully tested, with no strange behaviour reported. No deliberately
  32.  destructive code has been used.
  33.  
  34.    If you do not agree with the above paragraph, you should remove any
  35.  files associated with JCAL, including the distribution package, from your
  36.  computer system.
  37.  
  38.  
  39. --------------------------------------------------------------------------------
  40.  3. FILE LIST
  41.  
  42.    The following files should be included in the distribution package. If
  43.  any are missing, please report the problem to the administrator of the
  44.  system from which you obtained it, and obtain a new copy from a more
  45.  reliable source.
  46.  
  47. CALTEXT  LIS
  48. DESC     SDI
  49. FILE_ID  DIZ
  50. GETOPT   C
  51. JCAL     EXE
  52. JCAL     C
  53. SCBBS    COM
  54. SCIENCE  COM
  55. JCAL     DOC
  56.  
  57.  
  58. --------------------------------------------------------------------------------
  59.  4. HARDWARE REQUIREMENTS
  60.  
  61.  It Will work on any IBM combatable system. :-)
  62.  
  63. --------------------------------------------------------------------------------
  64.  5. WHAT IS JCAL ?
  65.  
  66.  
  67. JCAL. Produces a calander for the current system date.
  68.  
  69. --------------------------------------------------------------------------------
  70.  6. ACKNOWLEDGEMENTS
  71.  
  72.    Not all the work that went into this project is my own. My special
  73.  thanks go to the following:
  74.  
  75. Jonathan R Hudson, c/o SCBBS
  76.  
  77. --------------------------------------------------------------------------------
  78.  
  79.                         JCAL.EXE
  80.                         ========
  81. Synopsis
  82. --------
  83.  
  84. JCAL. Produces a calander for the current system date.
  85.  
  86. Usage
  87. -----
  88.  
  89. JCAL [-b bgcol] [-f fgcol] [-x bricol] [-p prolog] [-e epilog] [events_file] 
  90.  
  91. where:
  92.  
  93.         bgcol  is the background colour, default is 7 (grey)
  94.         fgcol  is the foreground colour, default is 0 (black)
  95.         bricol is the colour for today's date, default is 1 (red)
  96.                    this is in bold.
  97.         prolog is soome arbitary text displayed before the calander
  98.         epilog is soome arbitary text displayed after the calander
  99.  
  100.         events_file is a file containing a list of today's events; if
  101.                     this file is missing, no events are displayed.
  102.  
  103. The output of the program may be directed to a file using the standard
  104. redirection (>) symbol.
  105.  
  106. e.g
  107.         C:\> JCAL >C:\Wildcat\Disp\Hello5.BBS
  108.  
  109. would write the calander to the file TODAY.CAL.
  110.  
  111. If the 'prolog' or 'epilogue' text contains spaces, it must be
  112. enclosed in quotes. 
  113.  
  114. e.g.
  115.    C:\> JCAL -p @CLS@ -e "@PAUSE@ @BEEP@" >C:\Wildcat\Bull\Bull50.BBS
  116.  
  117.  
  118. Example
  119. -------
  120.  
  121. If a file caltext.lis exists, containing the following lines:
  122.  
  123. This is the jcal.exe calander program
  124. produced for Science Club BBS by Ahmed Al-Kalbani
  125.  
  126. then the command:
  127.  
  128.         C:\> JCAL >TODAY.CAL CALTEXT.LIS
  129.  
  130. would print the calander with a two line "Today's Event" box.
  131.  
  132. the output would be:
  133.  
  134.                        ==================================
  135.                       |           January 1996           |
  136.                       |----------------------------------|
  137.                       | Su   Mo   Tu   We   Th   Fr   Sa |
  138.                       |----------------------------------|
  139.                       |    |  1 |  2 |  3 |  4 |  5 |  6 |
  140.                       |----------------------------------|
  141.                       |  7 |  8 |  9 | 10 | 11 | 12 | 13 |
  142.                       |----------------------------------|
  143.                       | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
  144.                       |----------------------------------|
  145.                       | 21 | 22 | 23 | 24 | 25 | 26 | 27 |
  146.                       |----------------------------------|
  147.                       | 28 | 29 | 30 | 31 |    |    |    |
  148.                        ==================================
  149.  
  150.                                  Today's Events                   
  151.               ====================================================             
  152.              | This is the jcal.exe calander program              |
  153.              | produced for Science Club BBS by Ahmed Al-Kalbani  |
  154.               ====================================================             
  155.  
  156. Bugs
  157. ----
  158.  
  159. The program will only work reliably between 00:00:00 on 1st January
  160. 1970 and 07:14:07 on Tuesday, 19th January 2038. The author does not
  161. consider this a serious problem and has no intention to fix it.
  162.  
  163.  
  164. 1/1/96 version 0.00
  165. 2/1/96 version 0.01
  166. 3/1/96 version 0.02 (getting there)
  167.  
  168.  
  169.  12. CONTACTING THE AUTHOR
  170.  
  171.                 Science Club BBS
  172.                 +968 593728   28800 USR Sposter Node#1
  173.                 +968 593729   14400 USR Sposter Node#2
  174.  
  175.  
  176. My Address      Ahmed Al-Kalbani
  177.                 P.O Box 463, 118
  178.                 Al-Harthy Complex
  179.                 Sultante Of Oman
  180.  
  181.  
  182.  
  183.  
  184.    If you have any questions or comments about JCAL, please send them to
  185.  me at the above addresses. I respond to everything I receive. If you don't
  186.  get a response after a reasonable amount of time, try again, perhaps using
  187.  one of the alternate addresses, in case something happened to your
  188.  original message.
  189.  
  190.    I will also endeavour to keep anyone who contacts me informed about the
  191.  current progress of newer versions of JCAL.
  192.  
  193.    If you like JCAL and continue to use it, I would appreciate a postcard
  194.  sent to the above address. This is a request, not a requirement.
  195.  You can't imagine how much of an ego boost it is for me to receive
  196.  postcards, and they look really cool all stuck up on my wall.
  197.  
  198.    Thanks for giving my software a try. Thanks also for reading this
  199.  document. (This doesn't apply if you were lazy and skipped to the bottom
  200.  without reading it just to see if there was a bonus :-) )
  201.  
  202.    Ahmed AL-Kalbani
  203.    Jan 1996
  204. --------------------------------------------------------------------------------
  205.  
  206.